Publication Number S29-630R02 


SOURCE UPDATER 
USER GUIDE 


PERKIN-ELMER 


ter Systems Division 
2Crescent Place 
Oceanport. N.J.07757 


Copyright ©1977 by Perkin-Elmer Corporation Printed in U.S.A. May 1979 


PAGE REVISION STATUS SHEET 


PUBLICATION NUMBER 529-630 
TITLE Source Updater User Guide 


REVISION RO2 pate May 1979 


A1898 


PREFACE 


This manual describes the Perkin-Elmer utility, Source Updater,s 
that provides the operator with the capability to mzintains copys 
ana change source files on bulk storage devicese Configurations 
Logical unit assignments, and a complete description of each 
command are givene 
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CHAPTER 1 
INTRODUCTION TO SOURCE UPDATER 


lel GENERAL 


The Source Updatere @ common mode utility programs provides’ the 
operator with the ability to create and maintain source files on 
bulk storage devicese These commands enable the operator te 
copys verifye modifyse or List source filese To position and 
access files,y commands for positioning to a desirec name file 
starting with ** are providede Although the Source Updater 
primarily processes source on magnetic medias any media can be 
rrocessed by assigning the desired device. 


1e2 CONFIGURATION 
The Source Updater requires this configuration to executes: 
@ OS/16E MT2 or OS/32 


@ command input and List devices 


1e3 LOGICAL UNIT ASSIGNMENTS 


The Source Updater program uses these Logical units (LUs) 
assignments: 


AS 1 input source file (Cold master) 
AS 2 output source file (new master) 
AS 3 list device 

AS 4 update source 

AS 5 command tnput device 

AS 6 error log device 


LUsS 3+ 5e and 6 must be assigned by operator commandse LUs 19 29 
and 4 may be assigned by the operator or Source Updater commandse 
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‘Most error output goes to LU 3-6 If the commmend device is 
interactive and is not assigned to the same device as LU 3,9 error 
cutput also goes to LU 5e 


If assiqneds error output can also go to LU €e If it is not 
assigneds error output defaults to LU 3 and LU 5e 


164 DEFAULT DATA BLOCK SIZE (€32-BIT ONLY) 


The Source Updater allocates its output files with a default data 
block size of Se If this block size is greater than the maximum 
established at SYSGEN time, the program repeatedly allocates a 
smaller block size until it is equal to the maximum established 
at SYSGEN timee 
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CHAPTER 2 
SOURCE UPDATER COMMANDS 


2e1 GENERAL 


With the exception of the UPDATE command, all commands are input 
from LU Se The UPDATE command causes temporary transfer of 
command input to a user-specified file descriptor (fd) that is 
assigned to LU 4e 


Any invalid commands are rejected with a messages ands if not’ in 
interactive mode» the task is pausede If continueds a new 
command ts requestede An invalid parameter also causes’ the 
command to be rejected and a new command to be requestede 


Most commands require at least an input and output source file, 
denoted by "to® and "from" itn the command formate Some commands 
use a label for positioning purposess denoted by "label" in the 


command formate Label is from one to eight alphanumeric 
characterse The actual string that is searched for on the file 
is: 

*x*xlLabel 


Some commands require sequence numbers, denoted ty "seqnbr"s 
consisting of eight characters that are divided into an 
alphabetic portion and decimal portione The alphatetic portion 
can be from 0 to 7 characters ending in an alphabetic character 
and the decimal portion can be from 1 to 8 characterse Any of 
these sequence numbers are valid: 


ABC12345 
A0Q00000 
ABCDE000 
00000000 
D4E00000 
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The RESEQUENCE command increments only the decimal part of the 
sequence numbere The alphabetic characters remain fixede 


Bracketsy Cle are used to enclose optional arguments of Source 
Updater commandse 


Source Updater commandss which require file descriptors as 
argumentss can specify the currently assigned fd by specifying « 
cr by omitting the fc specificatione ‘If fd is specified, no 
action is taken if it is currently assigned; if fd is not 
specifieds the LU is closed and the specified fd is assigned. 
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2e2 FIND COMMAND 
The FIND command searches the source file for the specified label 


and positions the file immediatedly following the record 
containing the Label. 


Formats 


FIND lLabet Cefrom] 


* 


Parameters: 
Label is a user-specified alphanumeric character 
string Located in a record on the source filee 


from is a user-specified file descriptor indicating 
the input source file. 


* is the current input source file assigned to 
LU 1e 


Programming Considerations: 


When the Label is founds the next command is requestede If the 
label is not founds a message is output to the error Logging 
devices and no record positioning occurs before the search for 
the specified label startse 


If from is omittec or * is specifiedsy the current input source 
(LU 1) is assumede 
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| COPY | 


2e35 COPY COMMAND 
The COPY command ts used to COPY source files consisting of 
80-byte records to an output filee 
Formats 
COPY Cfrom] Cetol] Ceending string Cecolumn number) 


Parameters: 


from is the input source filee 
to is the output source filee 


If both from and to are omitted or « is 
specified, the current file is selected. 


ending string if specifieds the copy operation terminates 
upon copying the record that contains’ this 
ending stringe When an ending string is 
specifiedse but not found in the texts a 
message to that effect is printece 


column number’ if specifieds scanning the ending string 
starts at this column position in each input 
records, skipping leading blankse If this 
argument is omitted» it defaults to i.e 


Programming Considerations: 


A // encountered in columns one and two on the input device is 
treated as an end-of-file marker. 


The COPY operaticn terminates when end-of-file/end-of-medium 


(EOF/EOM) is reached or when a record containing the 
user-specified ending string is encounterede 
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LIST 


2e4 LIST COMMAND 


The LIST command provides a listing of a source file on the 
specified list device. Each page is numbered and contains up to 
58 linese 


Formats 


LIST Cfrom] Cylabel J 


Parameters: 
from specifies the input source file. If from is 
omitteds or if * is specifiecs the current 
input (LU 1) is usede 
Label specifies the label that is to be found prior 


to beginning the List operatione If label is 
omitted» no positioning is performede 


Programming Considerations: 


The List operation is terminated when EOF/EOMe or ae statement 
containing // in columns one and twos is detectede 
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TABLE 


2e5 TABLE COMMAND 


The TABLE command scans the specified input file anc Lists all 
program lLabets on the List devicee Thus» the source file"s table 
of contents, which contains many labeled programsys can be 
obtainede Program labels are indicated by two asterisks in the 
first two character positions of a recorde 


Format: 


TABLE Cfrom] 


* 


Parameters: 
from specifies the input source file. If from is 
omitted or if *«* is specifiede the current 
input source file (LU 1) is usede 
* indicates program labelse 
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UPDATE 


2e6 UPDATE COMMAND 


The UPDATE command puts the system in the update moce and sets up 
various parameters for the following update commands: 


@ REPLACE 
e@ INSERT 
e DELETE 
e MODIFY 
@e SELECT 
e ENDUP 


These commands are valid only when in UPDATE mocee 


Forsats 


UPDATE Cupdate) Cyfrom] Cytol] Cyending string 
Cycolumn number] 


Parameters: 
update indicates the file from which the update 
commands are to be read (LU 4). 
from indicates the old master; that is, the file to 
which the changes are to be madee 
to indicates the new master or file that is to be 


createde 


ending string if specified, the update operaticn terminates 
upon dating the record that contains’ this 
ending stringe When an ending string is 
specifieds, but not found in the texts a 
message to that effect if printed. 


column number’ if specifieds scanning the ending string 


starts at this column position in each input 
record, skipping leading blankse 
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Programming Considerations: 


If any of the first three parameters are omitted or if * is 
specified» the current file for that parameter is assumede 


If the fd specified in the third parameter does not exists, an 
indexed file by that name is allocated with a logical record 
Length of 80 bytese 


A form feed is issued on the List device at the start of an 
updates; anc if available,e the time and date are printed at the 
top of the UPDATE Listinge The UPDATE operation processes” alt 
commands from LU 4, updating the old master to the new master 
until an ENDUP command its encountered on LU 4 or until an EOF/E0M 
or ending string is encountered while being written to the new 
master (LU 2),_9 whichever comes firste All updates should be made 
in order of ascending sequence numberse 
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INSERT 


2e?f INSERT COMMAND 
The INSERT command is used to insert one or more new statements 
into an existing source programe The records following the 


INSERT command are inserted in the new master until a record with 
a /* in columns one and two is read from the update logical unit. 


Formats 
INSERT seqnbr 
Parameterss 


seqnbr is the sequence number after which one or more 
new statements are to be insertede The new 
statements are read from LU 4. 


Programming Considerations: 
To insert two statements after XXX00150,9 the following statements 
must be entered on the Update Logical Unit (LU 4)¢ 

INSERT XXX000150 

- statement #1 - 


- statement #2 - 
/* 


Error Messages: 


If a sequence number is detected on the old master that is larger 
than seaqnbr or an EOF/EOM or the ending string is detecteds this 
error message: 

SEQ NBR NOT FOUND 


is printed on the List device and the command input devices if 
that device is interactivee The operation is then atortede 
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DELETE 


2e8 DELETE COMMAND 


The DELETE command provides the capability to delete single 


statements or multiple statements from the input source 
file---old master (LU 1). 


Formats 
| DELETE seqnbri Ceseqnbr2] 
Parameters: 
seqnbrl specifies the sequence number of the first 
statement to be deleted. 
seqnbr2 if specified, statements between seqnborl and 


seqnbr2 inclusive are deletede If seqnbr2 is 
omitteds only the statement specified by 
seqnbri is detetede 


Prograasgsing Considerations: 


To delete statements AAA0N1010 through AAA01500,_, this command is 
entered: 


DELETE AAA01010.AAA01500 


Error Messages: 
If a sequence number is detected on the old master that is larger 
than seqnbri or seqnbr2, the error messages 
SEG@ NBR NAOT FOUND | 
tor seqnbri1 is printed on the list devicee 
The error message: 
SECOND SEQ NBR NOT FOUND 


is printed on the List device for seqnbr2e The operation is 
aborted when a sequence number is not founde 
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MODIFY 


2e9 MODIFY COMMAND 
The MODIFY command is used to detete a single statement = and 
insert a new statement in its placee 
Formats 
MODIFY seqnbr 


Parameterss 


seaqnbr indicates the sequence number of the statement 
to be modified. 


Programming Considerations: 


To use the MODIFY command to delete statement AAA01000 and 
replace it with a new statement, this sequence must be entered on 
the Update Logical Unit (LU 4)°: 

MODIFY AAA01000 

- new statement - 


Error Messages: 


If the sequence number cannot be founde this error message? 


SEQ NBR NOT FOUND 


device is an interactive device} and the error devices if it was 


is printed on the list devices; the command input devicee if ‘esl 
assignede 
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| REPLACE | 


2010 


REPLACE COMMAND 


The REPLACE command is used to modify a spectfied statement and 
to insert additional statements. 


Formats 


Para 


REPLACE seqnbri Csseqnbr2] 


meters: 


seqnbr 1 


seqnbr2 


indicates the sequence number of the statement 
where the insert procedure is to begine 


indicatess if specifieds the second Limit of 
a range of lines to be replaced by those 
entered in the insert lLinese If seqnbr2 is 
omitteds only the Line designated by seqnbri 
is deleted. 


Programming Considerations: 


If the sequence number cannot be founds» an error message is 
generatede 


REPLACE is terminated by a statement with a /* in columns one and 


twWo0e 


2-12 
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SELECT 


2e11 SELECT COMMAND 


The SELECT command is used to modify or to insert scurce lines at 
selected locations specified by sequence numberse 


Formats 


SELECT 

Line 1 seqnbri 
Line 2 seqnbr2 
Line 3 seqnbr3 


ja 
Parameterss 
seqnbr is a sequence number consisting of eight 
characterse 
Line is a source Linee 


Prograaming Consitderationss: 


The sequence numbers (seqnbries seaqnbr2e etce) start at column 73 
in an 80-byte recorde 


When a sequence number is found in the old master that matches 
the sequence number specifiede a modify is then in effect. If a 
sequence number is found that is larger than the one searched 
for» one tine is inserted before the larger sequence number. 
When sequence numbers in the SELECT input file are out of ordery 
a message is printed; buts processing is continuede SELECT is 
terminated with a record with /* in columns one and twoe 
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RESEQUENCE © 
- ENDUP 


20°12 ENDUP COMMAND 


The ENDUP command terminates the UPDATE mode. 
Formats 


ENDUP 


Programming Considerations: 


If the ending string was reached before the ENDUP»s copying is 
terminatede If the ending string has not yet been encountered, 
the old master is copied onto the new master until it reaches the 
ending string or EOF/EOMe. 
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2e13 RESEQUENCE COMMAND 
The RESEGUENCE command is used to resequence ae specified file. 
It increnments only the decimal part of the sequence numbere 


Formats 


RESEQUENCE fromgstart seqnbrl,incr Il ygtoileending string 
Ccolumn numberJ] 


Parameterss 


from is the file to be resequencedce 
start specifies the starting sequence number. 
iner is the sequence number increments if omitted, 


decimal 10 is assumed. 
to specifies the output resequenced file. 


ending string specifies an ending string anc column number 
and for the start of the ending stringe 
column number 


Programming Considerations: 


If to is omitted, resequencing is done in place; that ise 
resequencing is to the from filee If the to file is specified 
but does not exists an indexed file is created with ae tlogical 
record length of 80 bytes and a block size of 5 sectorse (See 
Section 1-4) If the from file is a magnetic tape medium, then 
resequence in place cannot be donee Resequencing .continues until 
a // in columns one and two» and EQF/EOMs or the ending string is 
encountered on the input filee 


Specifying any ending string and column number for the start of 
the ending string allows the user to resequence cifferent parts 
of a file with different sequence numberse Howevers when a 
resequence in place is donesy the file is logically rewound at the 
start of each resequence commande 
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VERIFY | 


2014 VERIFY COMMAND 


The VERIFY command is used to compare one _ source fite with 


anothere 


Formats 


“VERIFY CfromiCetolJ0CeniCyending string Ccolumn number] 


Parameters: 


from and to 


ending string 


column number 


indicate the two source files to be verifiede 
If the first or second parameter is omitted or 
* is specified,s the current file assignment is 
assumede 


specifies a decimal number between 1 and 80 
and indicates the number of bytes to be 
comparede If nis omitteds alt 80 bytes are 
comparede 


is optional and atlows two files to be 
verified to an ending stringe 


defines the column number for the start of the 
ending strings the default is column onee A 
// in columns one and two is treated as an 
end-of-file. 


Programming Considerations: 


Verification is 


terminated normally when an end-of-file is 


detectede An abnormal termination is detected when a mismatch is 
cdetectede When a mismatch is detectedy this message: 


**kVERIFICATION ERROR«** - Record 1 - - Record 2 - 


is printed on the List device (LU 3); the command input device 
[coy 5)-« if that device is an interactive devices and the error 
devices if assigned. 


Record 1 is the source statement read from LU 1 and Record 2 is 
the statement read from LU 2. 
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EXCEPTION 


2e15 EXCEPTION COMMAND 
The EXCEPTION command allows the user to generate a listing that 


contains alt source statements differing between two source 
filese 


Formats 


XCEPTION CfromJCetolCenIleending string Cscolumn numberJ] 


Parameters: 


from anc to indicate the two source files to be compared. 
If the first cr second parameter is omitted or 
* is specified,s the current file assignment is 


assumede 

n specifies a decimal number between 1 and 80 
and indicates the number of bytes to be 
comparede 


ending string its optional and allows the two files to be 
compared to an ending stringe 


column number defines the column number for the start of the 


ending strings the default is column onee A 
// in columns one and two is treated as an 
end-of-file. 


Error Messages: 


If a mismatch occurss the message: 

week EXCEPTION ERROR CN LUn *«% 
is printed. Following this messages a list of the nonmatching 
records of the devicey with the lower sequence numbers of the 


twos is output until the files are realized or until an 
end-of-file occurse 
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NM 


a17 


If the sequence numbers are identical, but the data in the 
remaining records does not compares no attempt to align is madee 
The messages 

axe EXCEPTION MISMATCH ««« 
is displayed and both offending Lines are printed. 


If an end-of-file occurs on one device and not on the other, the 
fressages 


*x*e EOF ON UNIT n 


is displayed followed by a List of the remaining records. 
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BUILD 


2e16 BUILD COMMAND 


The BUILD command puts the Source Updater into a moce that = only 
allows INCLUDE commands to be processede This command specifies 
the file to be used as the output build file (LU 2) in subsequent 
INCLUDE commandse 


Formats 
BUILD fd 
Parameters: 


fd if it does not exist, it is allocated on the 
system default volume as an indexed file with 
a logical record length of 80 bytes. 


Programming Considerations: 


A BUILD is terminated by an ENDB statemente 
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INCLUDE 
ENDB 


2e17 INCLUDE COMMAND 


The INCLUDE command causes source statements to be copied from a 
file specified in the operand of this command to a file specified 


by a BUILDe 


INCLUDE its terminated when a statement heginning 


with // or EOF/EOM is encounterede 


Formats 


INCLUDE Cfd JC label] 


Parameters: 


fd 


Label 


2018 ENDB COMMAND 


1f omitteds the current input file is assumede 
The statement that terminated the INCLUDE is 
not copied to the BUILD file. 


if specified» the include file is positioned 
to the statement after the label before 
copyinge 


The ENDB command writes a record containing an ENDUP statement to 
the build files writes a filemark, terminates the scope of a 
FUILDs and causes the build file to be rewounde 


Formats 
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REWIND 
PAUSE 


END 


2e19 REWIND COMMAND 


The REWIND command rewitnds a specified filee 


Formats 


REWIND fd 


2e20 PAUSE COMMAND 
The PAUSE command causes the program to relinquish control to the 
operating system via a pause SVC (SVC 2 Code l)e 
Formats 
PAUSE 
2e21 END COMMAND 
The END command causes the Source Updater progrem to go to 


end-of-task via an SVC 3-6 


Formats 
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